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com.ibm.speech.net.www.protocol.https 

Class HttpsClient 

j ava . lang . Ob j ect 
I 

+--com. ibm. sslight . SSLContext 

i 

+ — com . ibm. speech . net . www .protocol . https . HttpsClient 



public class HttpsClient 

extends com.ibm.sslight.SSLContext 



Inner classes inherited from class com.ibm.sslight.SSLContext 

com . ibm . sslight . SSLContext . KeyConstraints 



Field Summary 


static int 


CONNECTED 

Connection established. 


static java . lang . String 


defaultKeyRingD at abase 

Default key ring database. 


static int 


defaultPort 

Default port allocated for HTTPS provided by HTTP RFC. 


static int 


NOT CONNECTED 

Connection not established. 


static java . lang . String 


sslCertlssuerName 

Certificate Issuer Name of SSL established connection. 


static java . lang . String 


sslCertOrgName 

Certificate's Organization Name of SSL established connection. 


static java . lang . String 


sslCipherSuite 

Cipher suite of SSL established connection. 


static java . lang . String 


sslCompressMethod 

Compression method of SSL established connection. 


static java . net . Inet Address 


sslInetAddress 

java.net.Inet Address of SSL established connection. 


static int 


sslPort 

Port of SSL established connection. 
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Fields inherited from classrom.ibm.ssIight.SSLContext 

asyncConnections, CA, clientAuthentication, CONNECT , CONNECTION, debug, SESSION, 
SITE 



Constructor Summary 

HttpsClient ( j ava . net . URL u) 

Creates a new HttpsClient instance with the default debug flag. 

HttpsClient ( j ava . net . URL u, boolean debug) 

Creates a new HttpsURLStreamHandler instance with a specified debug flag. 



Method Summary 


void 


connect ( ) 

Method that calls that sets up SSL connection. 


void 


connect ( j ava . lanq . String host, int port) 

Method that established SSL connection. 


void 


disconnect { ) 

Close the connection to the server. 


j ava . lang . String 


getHTTPHeader ( ) 

Returns the header from the HTTP request. 


j ava . io . InputStream 


get InputStream ( ) 

Returns a input stream that reads from this open connection. 


java . io .OutputStream 


getOutputStream ( ) 

Returns a java.net.OutputStream that writes to this connection. 


int 


getState ( ) 

Returns the current state of the connection. 


protected boolean 


handleCertif icateChain (com. ibm. sslight . SSLCert [ ] chain) 

This method is called by SSL if a certificate chain has to be validated by 
the SSL protocol but that cannot be done based on the information stored in 
the public key ring associated with the context or there is no public key ring 
defined at all. 


void 


setAsynConnections {boolean value) 

Sets the value of the asyncConnectionSet field for the HttpsClient 
object to the specified value. 


void 


setEnableCipherSuites ( j ava . lang . String cipherSuites ) 

Sets the value of the enabledCipherSuites field for the 
HttpsURLConnection object to the specified value. 


void 


setEnabledCompressionMethods ( j ava . lang . String methods ) 


Sets the value of the enabledCompressionMethods field for the 
HttpsClient object to the specified value. 


void 


setKeyRingDatabase ( j ava . lang . String name ) 

Sets the value of the keyRingDatabase field for the HttpsClient 
object to the specified value. 


void 


setRequestMethod (java . lanq . Strinq method) 

Sets the value of the method field for the HttpsClient object to the 
specified value. 



• 
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void 


setRe^rast Proper ties ( j ava . lang . String properties ) 

Sets the value of the requestProperties field for the HttpsClient 
object to the specified value. 


void 


setTimeout ( int seconds) 

Sets the value of the timeout field for the HttpsURLConnection object 
to the specified value. 



Methods inherited from class com.ibm.sslight.SSLContext 

allows tepUpCryptography, clone, conf irmCertif icateChain, conf irmKeySelection, 
exportKeyRings, getEnableciCipher Suites, get EnabledCompressionMet hods , 
getKeyRing, getSSLCertByLabel , get Timeout , handle.Certif icateChain, 
handleConnection, handleNoPeerCertif icate, handleNoSiteCertif icate , 
importCACertif icates, importKeyRings , importKeyRings , importSiteCertif icates , 
queryAcceptableKeys, restricts tepUpCryptography, setEnabledCipherSuites , 
setKeyRing, setTimeout 



Methods inherited from class java.lang.Object 

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, 
wait 



Field Detail 



sslPort 

public static int sslPort 

Port of SSL established connection. 



sslInetAddress 

public static j ava . net . InetAddress sslInetAddress 

java.net.InetAddress of SSL established connection. 
ssICompressMethod 

public static j ava . lang . String ssICompressMethod 
Compression method of SSL established connection. 

sslCipherSuite 

public static j ava . lang . String sslCipherSuite 
Cipher suite of SSL established connection. 
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sslCertOrgName 

public static java . lang . String sslCertOrgName 

Certificate's Organization Name of SSL established connection. 
sslCertlssuerName 

public static java . lang . String sslCertlssuerName 

Certificate Issuer Name of SSL established connection. 



NOTCONNECTED 

Q public static final int NOT_CONNECTED 

Connection not established. 

' sis' 

% CONNECTED 

public static final int CONNECTED 

m Connection established, 

g defaultPort 

public static final int defaultPort 

Default port allocated for HTTPS provided by HTTP RFC. 
defaultKeyRingDatabase 

public static final java . lang . String defaultKeyRingDatabase 

Default key ring database. 

Constructor Detail 

HttpsClient 

public HttpsClient (java . net . URL u) 
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Creates a new HttpsClient instance with the default debug flag. 
Parameters: 

u - the java.net. URL associated with the connection. 



HttpsClient 

public HttpsClient (java.net . URL u, 

boolean debug) 

Creates a new HttpsURLStreamHandier instance with a specified debug flag. 
Parameters: 

u - the java.net.URL associated with the connection. 

dbg - the boolean value of turning the debug option ON/OFF. 



Method Detail 



handleCertificateChain 

protected boolean handleCertificateChain (com. ibm. sslight . SSLCert [ ] chain) 

This method is called by SSL if a certificate chain has to be validated by the SSL protocol but 
that cannot be done based on the information stored in the public key ring associated with the 
context or there is no public key ring defined at all. It can be overridden in a subclass of 
SSLContext If not redefined, this method returns false, which means the certificate chain is not 
verified. In that case the connection establishment is aborted. 
Parameters: 

chain - the SSLCert [ ] assoiciated with the connection. x509chain - the chain of 
X509.v3 certificates, ordered with the sender's certificate first an the root certificate 
authority last, correlator - used by the application to associate the handshake with some 
application defiend Object. This is the same correlator that was used on the SSLSocket 
constructor or the "accept" for the SSLServerSocket, depending on whether the current 
role is client or server. 



getlnputStream 

public java . io . Input Stream getlnputStream ( ) 

throws j ava . io . IOException 

Returns a input stream that reads from this open connection. 
Returns: 

an java.io.InputStream that reads from this open connection. 
Throws: 

java.io. IOException - if an I/O error occurs while creating the input stream. 



getOutputStream 

public java . io . Output St ream getOutputStream ( ) 

throws java . io . IOException 
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Returns a java.net.OutputStream that writes to this connection. 
Returns: 

an output stream that writes to this connection. 
Throws: 

java.io.IOException - if an I/O error occurs while creating the output stream. 



connect 

public void connect () 

Method that calls that sets up SSL connection. 



connect 

public void connect ( j ava . lang . String host, 

int port) 
throws java.io.IOException 

Method that established SSL connection. 
Parameters: 

host - the host to request a connection from. 

port - the port the requested server is listening on. 
Throws: 

IOExeption - if an error occurs while establishing the connection. 



disconnect 

public void disconnect ( ) 

Close the connection to the server. 



getState 

public int getState ( ) 

Returns the current state of the connection. 
Returns: 

int the state of the connection 1 if connected, 0 otherwise. 



getHTTPHeader 

public j ava. lang. String getHTTPHeader ( ) 

Returns the header from the HTTP request. 
Returns: 
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setRequestMethod 

public void setRequestMethod ( j ava . lang . String method) 

Sets the value of the method field for the HttpsClient object to the specified value. 
Parameters: 

name - the new value. 



setRequestProperties 

public void setRequestProperties ( j ava . lang . String properties) 

Sets the value of the requestProperties field for the HttpsClient object to the specified 
value. 

Parameters: 

name - the new value. 



setKeyRingDatabase 

public void setKeyRingDatabase ( j ava . lang . String name) 

Sets the value of the keyRingDatabase field for the HttpsClient object to the specified 
value. 

Parameters: 

name - the new value. 



setTimeout 

public void setTimeout ( int seconds) 

Sets the value of the timeout field for the HttpsURLConnection object to the specified value. 
Parameters: 

seconds - the new value. 



setAsynConnections 

public void setAsynConnections (boolean value) 

Sets the value of the asyncConnectionSet field for the HttpsClient object to the specified 
value. 

Parameters: 

value - the new value. 
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setEnabledCompressionMethods 

public void setEnabledCompressionMethods (java . lang . String methods) 

Sets the value of the enabiedCompressionMethods field for the HttpsClient object to the 

specified value. 

Overrides: 

setEnabledCompressionMethods in class com.ibm.sslight.SSLContext 
Parameters: 

methods - the new value. 



setEnableCipherSuites 

public void setEnableCipherSuites (java. lang. String cipherSuites ) 

Sets the value of the enabiedCipherSuites field for the HttpsURLConnection object to the 

specified value. 

Parameters: 

cipherSuites - the new value. 
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